home *** CD-ROM | disk | FTP | other *** search
/ Technotools / Technotools (Chestnut CD-ROM)(1993).ISO / os2tools / backini / backini.doc next >
Text File  |  1992-05-26  |  6KB  |  166 lines
  1.                     Introducing BACKINI Version 1.0
  2.                     -------------------------------
  3.                     (C)1992 Turgut Kalfaoglu <TURGUT@FRORS12.BITNET>
  4.                                              <TURGUT@FRMOP11.BITNET>
  5.  
  6.  
  7. ABSTRACT:
  8.  
  9.         BACKINI allows you to make numbered backups of any files, going 
  10. back as many modifications as you would like. It only creates a new 
  11. backup file if the file it is processing has been changed since the last 
  12. backup.
  13.  
  14. Possible uses:
  15.         * Backing up all your \OS2\*.INI files against corruption
  16.         * Backing up vital data files or configuration files
  17.  
  18.  
  19. USER REGISTATION:
  20.  
  21. Regular use (over 10 days after obtaining the package) of this program 
  22. requires a registration form and a registration fee of $20 to be sent to 
  23. the author. Registration will entitle you to a free newsletter on 
  24. updates to this package and other software that may be of interest to 
  25. you. 
  26.  
  27.         
  28. SYSTEM REQUIREMENTS:
  29.  
  30.         BACKINI has been written and compiled with IBM C/SET 2 compiler 
  31. Version 1.0. It calls functions available only under OS/2 2.0, and is a 
  32. "Mixed 16-32 bit Application." Thus, you need OS/2 2.0 in order to use
  33. BACKINI.
  34.  
  35. USAGE:
  36.  
  37.         The syntax is:
  38.         
  39.            BACKINI  filespecs [filespecs..] [/V] num_of_backs
  40.            
  41.         filespecs: The name(s) of the files that you wish backed up. May 
  42.                    contain wildcard specifications.
  43.                    
  44.         /V:        Turns VERBOSE mode on. Useful to see exactly what the 
  45.                    program is doing.
  46.                    
  47.         num_of_backs  Determines the number of backup files to keep for 
  48.                    these files.
  49.                    
  50. BEHAVIOR:
  51.  
  52.         After expanding the filespecs, the program compares each file 
  53.         against its most recent backup copy, with the same name, but 
  54.         filetype ".Bnn" where nn is a sequential hex number. If the 
  55.         files differ, and the trailing number of the last backup file is 
  56.         NOT greater than the one specified at the command line, a new 
  57.         file, with a trailing number nn+1 is created. If the files 
  58.         differ, but the most recent backup file's trailing number is 
  59.         equal or greater than the number specified, then the file 
  60.         <filename>.B1 is erased, and all other backup files are renamed 
  61.         "upwards" by one, so that <filename>.B3 becomes <filename>.B2 
  62.         and so on. The program then creates a new backup file for this 
  63.         file, with the number equal to the one specified at the command 
  64.         line.
  65.         
  66.         Flow Diagram:
  67.         
  68.         1) Set execution priority to time critical: to prevent *.INI 
  69.            files becoming inaccessible, when BACKINI is used from 
  70.            CONFIG.SYS
  71.         2) Parse command options: load filenames, max_backup, and 
  72.            verbose flag.
  73.         3) For each filename:
  74.              3.1) Find latest file with a trailing number: 
  75.                   <filename>.Bnn. (Meaning, the greatest nn value)
  76.              3.2) Compare input file against the latest backup file. If 
  77.                   they are same, iterate (go on to next input file).
  78.              3.3) If nn is equal or greater than max_backup:
  79.                 3.3.1) Delete <filename>.B1
  80.                 3.3.2) Rename all other files "up" by one.
  81.                 3.3.3) Create <filename>.B<max_backup>
  82.              3.4) Else,  (nn is less than max_backup)
  83.                 3.4.1) Create <filename>.Bnn where nn is one greater 
  84.                        than the one found during 3.1
  85.         4) Terminate
  86.         
  87. NOT SUITABLE FOR:
  88.  
  89.         Any fileset that is stored in the same directory, and differs 
  90.         just by filetype. Their backup files will overwrite each other.
  91.         
  92.         Any directory that contains files named <filename>.Bnn  where nn 
  93.         is a number from 1 to the parameter entered at command line, and 
  94.         <filename> is a filename matching the specification entered at 
  95.         the command line. Such files may get overwritten by the program.
  96.         
  97. USAGE EXAMPLES:
  98.  
  99.         In CONFIG.SYS:
  100.         
  101.         RUN=C:\BIN\BACKINI C:\OS2\*.INI C:\CONFIG.SYS C:\AUTOEXEC.BAT 5
  102.            
  103.         ..would keep the latest 5 versions of your INI files, your 
  104.         CONFIG.SYS and AUTOEXEC.BAT.
  105.  
  106.         BACKINI C:\DOCS\SUMMER92\*.DOC /V 2
  107.         
  108.         ..would keep the latest 2 versions of your document files stored 
  109.         in the \DOCS\SUMMER92 directory. Since VERBOSE flag is 
  110.         specified, you will see the program's behavior.
  111.         
  112. ORDER OF PARAMETERS:
  113.         
  114.         The filename specifications can be entered in any order, and the 
  115.         /V flag can be specified anywhere in the command line. The ONLY 
  116.         LIMITATION is that the number specifying the number of backup 
  117.         files to keep must be the last parameter.
  118.  
  119. NOTES:
  120.         * The \OS2\OS2.INI and \OS2\OS2SYS.INI files may only be backed 
  121.         up when BACKINI is placed in the CONFIG.SYS. They are not 
  122.         accessible after the system has started.
  123.         
  124.         * BACKINI's comparison algorithm will detect file size 
  125.         variations, and will do a byte-by-byte comparison of the input 
  126.         file, and the last backup.
  127.         
  128.         * When run from CONFIG.SYS via RUN= statement, the program does
  129.         not provide any output. This is normal.
  130.         
  131.  
  132.         
  133. REGISTRATION FORM:
  134.  
  135.  
  136. First and Lastname: _______________________________________
  137.  
  138.  
  139. Address: _________________________________________________
  140.     
  141.  
  142.          _________________________________________________
  143.          
  144.  
  145. Version of Software: _______________
  146.  
  147.  
  148. Diskette Drive size: _______________
  149.  
  150.  
  151. Please return with payment to:
  152.  
  153.         Turgut Kalfaoglu
  154.         1378 Sok. 8/10
  155.         Alsancak, Izmir
  156.         Turkey
  157.         
  158. if you respond before August 1992, you may also mail to:
  159.  
  160.         Turgut Kalfaoglu
  161.         25 Rue de Versailles
  162.         78150 Le Chesnay
  163.         France
  164.         
  165.  
  166.